GET Ranks Details
/openmlbb/academy/ranks/{rank_id}
API Path: /api/academy/ranks/{rank_id}
Retrieve details for a specific rank in MLBB by rank ID. Supports query parameter for localization.
Path parameters:
- rank_id: Rank ID (validated dynamically from current rank list). Minimum: 1, Maximum: 9999.
Query parameters:
- lang: Language code for localized content (default:
en).
The response includes detailed rank data:
- records: Array of rank entries, each containing:
- _id: Unique record identifier.
- configId: Configuration ID.
- caption: Localized caption (e.g., '236-9999荣耀神话').
- createdAt: Creation timestamp.
- createdUser: Creator username.
- updatedAt: Last update timestamp.
- updatedUser: Last updater username.
- data:
- bigrank: Major rank ID (e.g., 7).
- bigrank_name: Major rank name (e.g., '荣耀神话').
- icon: Rank icon URL.
- rankid_start: Starting rank ID in the range.
- rankid_end: Ending rank ID in the range.
- id: Internal record ID.
- linkId: Linked object references.
- sort: Sorting index.
This endpoint is useful for:
- Displaying detailed information about a single rank tier.
- Explaining its position in the progression system.
- Guiding players in understanding MLBB's ranking structure.
Python Example
from OpenMLBB import OpenMLBB
client = OpenMLBB()
response = client.academy.rank_by_id(1, lang="en")
print(response)
Path and Query Parameters
| Name | In | Type | Required | Default |
|---|---|---|---|---|
| rank_id | path | integer | yes | - |
| lang | query | string | no | en |